home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / unirdw10.zip / RDW.DOC < prev    next >
Text File  |  1993-11-26  |  3KB  |  60 lines
  1.                          Uni-RDW (Report Day of Week)
  2.     A Free (but not Public Domain) Utility from UniNova Services Corporation
  3.                    (c) 1993 by UniNova Services Corporation
  4.  
  5. DISCLAIMER:  (You can thank a lawsuit-happy society for the inclusion of
  6. this paragraph.)  Uni-RDW, including RDW.EXE and RDW.DOC (hereafter referred
  7. to as "the software" or "the program" or "RDW") is provided as is, with
  8. absolutely no warranty or guarantee, implicit or explicit.  By using RDW on
  9. your system, you imply your agreement that you will accept full responsibility
  10. for the effects of your use, misuse, or inability to use RDW.
  11.  
  12. DESCRIPTION:  Uni-RDW is a simple program to tell you what day of the week
  13. it is (Sunday, Monday, etc.).  It's not as inane as that makes it sound,
  14. however, as it is really intended to determine that information from within
  15. a batch file, which will presumably perform differing actions dependent on
  16. the day of week.  This is particularly handy for bulletin board systems that
  17. may have once-a-week maintenance but the BBS software in use does not support
  18. such scheduling OR the front end being used with the BBS software prevents
  19. the use of such scheduling.
  20.  
  21. USAGE:  Simply call RDW and check the DOS ERRORLEVEL that is returned by the
  22. program.  If you are unfamiliar with using the ERRORLEVEL in a batch file,
  23. you are advised to review your DOS manual, especially if this document does
  24. not make sense to you.  The program will return the following error codes:
  25.     0 = Sunday
  26.     1 = Monday
  27.     2 = Tuesday
  28.     3 = Wednesday
  29.     4 = Thursday
  30.     5 = Friday
  31.     6 = Saturday
  32.     10 = Error condition that should be reported to UniNova.
  33. The following sample batch file will run the DAILY.BAT maintenance run every
  34. day, and the SUNDAY.BAT maintenance run every Sunday:
  35.         @echo off
  36.         CALL DAILY.BAT
  37.         RDW
  38.         IF ERRORLEVEL 1 GOTO END
  39.         CALL SUNDAY.BAT
  40.         :END
  41. Note that DOS evaluates as TRUE the condition IF ERRORLEVEL x for values
  42. equal to and greater than x; also, Sunday equals errorlevel 0; thus, it is
  43. necessary to check for an errorlevel higher than 0 to prevent running the
  44. SUNDAY.BAT file every day.
  45.  
  46. The program will also report the day of the week to the console so you can
  47. ensure correct operation.  The emoticon following the Monday and Friday result
  48. is intentional.
  49.  
  50. REGISTRATION:  You are granted a free limited license to use RDW.  There is
  51. no need to register, and you may redistribute RDW freely.  However, under no
  52. circumstances will you own RDW, and your license to use and redistribute it
  53. will be revoked in any of the following conditions:
  54.     1.  You redistribute a modified version of RDW.EXE or RDW.DOC;
  55.     2.  You charge more than $5 for materials/copying fee to redistribute RDW;
  56.     3.  You do not include the unaltered RDW.DOC file with RDW.EXE.
  57.  
  58. SOURCE CODE:  You may purchase the source code for personal information only
  59. for $15 from UniNova Services Corporation, PO Box 900, Ellensburg, WA 98926  
  60.